package com.weaving.monitor.mapper;

import com.weaving.monitor.entity.StaffUserCard;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 员工卡号数据访问层接口
 * 
 * 功能说明：
 * 1. 定义与staff_user_card表交互的数据库操作方法
 * 2. 提供通过卡号查询用户ID的功能
 * 
 * 注解说明：
 * - @Mapper: MyBatis注解，标识这是一个Mapper接口
 * 
 * 方法说明：
 * - selectByCardNumber: 根据卡号查询员工卡号信息
 * 
 * @author 系统开发团队
 * @version 1.0
 * @since 2024-01-01
 */
@Mapper
public interface StaffUserCardMapper {
    
    /**
     * 根据卡号查询员工卡号信息
     * 
     * 功能说明：
     * 1. 通过员工卡号查询对应的用户ID
     * 2. 用于建立卡号与用户ID的关联关系
     * 
     * 参数说明：
     * - cardNumber: 员工卡号
     * 
     * 返回值说明：
     * - StaffUserCard: 员工卡号信息对象，包含用户ID
     * - null: 如果未找到对应的卡号记录
     * 
     * SQL说明：
     * - 查询条件：card_number = #{cardNumber}
     * - 返回字段：id, card_number, user_id
     * 
     * @param cardNumber 员工卡号
     * @return 员工卡号信息对象
     */
    StaffUserCard selectByCardNumber(@Param("cardNumber") String cardNumber);
} 